.\"
.TH encdb 1 "19 Sep 2008" "ENCDB 1.4"
.SH NAME
encdb \- base de datos encriptada
.SH SINOPSIS
.BI "encdb -f " archivobd " -p " <ask> " -N " nombrebd " 
.br
.BI "encdb -f " archivobd " -p " <file:pathname> " -N " nombrebd " 
.br
.sp
.BI "encdb " ... " [ -i  ["archivo "] -n " nombre " ]
.br
.sp
.BI "encdb " ... " [ -o  ["archivo "] -n " nombre " ]
.br
.sp
.BI "encdb " ... " [ -d -n " nombre " ]
.br
.sp
.BI "encdb " ... " [ -c ]
.br
.sp
.BI "encdb " ... " [ -s ]
.br
.sp
.BI "encdb " ... " [ -l ]
.br
.sp
.BI "encdb " ... " [ "... " ] [ -g ]
.br
.sp
.SH DESCRIPCION
.B Encdb
es util para el guardado de informacion sensitiva encriptando
el contenido mientras esta siendo guardado e idenficando la data por medio
de un nombre. Este utilitario nacio de la necesidad de tener informacion
de cuentas como usuario/fraseclave en una forma segura.
.PP
.SH "OPCIONES"

.TP
\fB\-f \fI archivobd
Especifica la ruta del archivo a contener la base de dato(s).
.TP
\fB\-p \fI <ask|file:pathname>
Si es llamado "-p ask" encdb preguntara por la fraseclave. Si es llamado
"-p file:/ruta/a/archivo" encdb leera la fraseclave que contiene el archivo,
archvio puede ser un "named pipe".
.TP
\fB\-N \fI nombrebd
El nombre de la base de datos a accesar en el archivo especificado. Opcional.
.TP
\fB\-c\fR
Crea una base de datos en el archivo especificado.
.TP
\fB\-i \fI archivo \fR| \fI\-
Inserta data de un \fIarchivo\fR a la base de datos
asociado a un nombre con la opcion \fB\-n\fR \fInombre\fR.
Si \fInombre\fR es '\fI-\fR',
entonces la data sera leida de la entrada standard
hacia la base de datos.
.TP
\fB\-o \fIarchivo \fR| \fI\-
Extrae la data referida por la opcion \fB-n\fR \fInombre\fR
y la pone en \fIarchivo\fR. Si \fIarchivo\fR es '\fI-\fR', entonces
sera escrita a la salida standar.
.TP
\fB\-s\fR
Inprime stadisticas internas de Bdb. Tambien reporta la fecha de creacion
y la fecha del ultimo cambio.
.TP
\fB\-d\fR
.\" debugueo ?
Borra una entranda en la base de datos.
.TP
\fB\-l\fR
Printea todas la entradas ( nombres ). La salida de cada entrada
es seguida por el largo del nombre y por el tamano del contenido 
a que refiere, siendo estos tres campos delimitado por una coma ','.
Al final del listado el total de todos los tamanos seran printeados.
.sp
.TP
\fB\-g\fR
Printea informacion de debugeo.
.sp
.SH EJEMPLOS
.sp
.TP
\fBencdb -f \fI\^$HOME\^/.trabajo_ids.edb \fB\-p\fR \fIask\fR \fB\-N\fR \fIcuartosrv1\fR \fB\-c\fR
.sp
Esto creara una base de dato llamada \fIcuartosrv1\fR en el archivo \fI.trabajo_ids.edb\fR
y pregunta por la frase clave.
.sp
.TP
\fBencdb -f \fI\^$HOME\^/.trabajo_ids.edb \fB\-p\fR \f file:/ruta/a/archivo\fR \fB\-N\fR \fIcuartosrv1\fR \\
\fB\-i\fR \fI\^$HOME\^/servidores/s1_cuenta \fB\-n\fR \fIs1\fR
.sp
Este ejemplo guardara el contenido de \fI\^$HOME\^/servidores/s1_cuenta\fR en la base de datos
\fIcuartosrv1\fR con el nombre \fIs1\fR y la fraseclave encontrada en el archivo \fI/ruta/a/archivo\fR
.sp
.TP
\fBencdb -f \fI\^$HOME\^/.trabajo_ids.edb\fR \fB\-p\fR \fIask\fR \fB\-N\fR \fIcuartosrv1\fR  \\
\fB\-o\fR  \fI\-\fR  \fB\-n\fR \fIchavo\fR
.sp
Este ejemplo printea a la salida standar el contenido referenciado por el nombre \fIgoofy\fR
a la salida standar.
.sp
.SH NOTAS
.sp
Este programa es similar a algunos utilitarios de BerkeleyDB-4.x pero con un poco
mas de opciones y de proposito.
.sp
El algoritmo usado para la encriptacion es AES-256 del OpenSSL.
en caso de cualquier mala fortuna resultando en corrupcion de la base de datos por problemas 
del sistema operatio, perdida de energia o error del programa, se puede usar los utilitarios 
de BerkelyDB para salvar la data.
.sp
.SH AUTOR
.TP
Antonio L. De Leon <aldleonm@gmail.com>
.br
